Command: ConfigCmds (Configure Commands). The HSM must be in the Secure state.
Function: To enable or disable host and console commands.
Commands are enabled or disabled using the following syntax:
[+ or -] [C or H] [<Command Code>]
+ indicates that the specified command
should be enabled.
- indicates that the specified command should be disabled.
C indicates that <Command Code> is a Console command.
H indicates that <Command Code> is a Host command.
<Command Code> is the command code to be enabled or disabled, and
may contain the wildcard character ‘*’. If the first character is ‘*’,
then the second character is absent, and this matches all command codes
of the specified type. If the second character is ‘*’, then this matches
all command codes of the specified type starting with the given first
character.
Inputs: List of
host commands to enable.
List of console commands to enable.
List of host commands to disable.
List of console commands to disable.
Outputs: Complete list of
enabled host commands.
Complete list of enabled console commands
Errors: Invalid Entry
Example 1:
This example demonstrates the use of the ConfigCmds console command to enable one console command (DE) and disable one host command (A4)
Secure> ConfigCmds <Return>
List of enabled Console commands: GC, GS, EC, FK
List of enabled Host commands: A0, A4, GG, GY
Enter command code (e.g. +CDE) or Q to Quit: +CDE<Return>
List of enabled Console commands: GC, GS, EC, FK,
DE
List of enabled Host commands: A0, A4, GG, GY
Enter command code (e.g. +CDE) or Q to Quit: -HA4<Return>
List of enabled Console commands: GC, GS, EC, FK,
DE
List of enabled Host commands: A0, GG, GY
Enter command code (e.g. +CDE) or Q to Quit: Q<Return>
Secure>
Example 2:
This example demonstrates the use of the ConfigCmds console command using the wildcard character ‘*’ to disable all host commands, and then enable just those host commands beginning with ‘S’.
Secure> ConfigCmds <Return>
List of enabled Console commands: GC, GS, EC, FK
List of enabled Host commands: A0, A4, GG, GY
Enter command code (e.g. +CDE) or Q to Quit: -H*<Return>
List of enabled Console commands: GC, GS, EC, FK
List of enabled Host commands:
Enter command code (e.g. +CDE) or Q to Quit: +HS*<Return>
List of enabled Console commands: GC, GS, EC, FK
List of enabled Host commands: SA, SC, SE, SG
Enter command code (e.g. +CDE) or Q to Quit: Q<Return>
Secure>
Example 3:
This example demonstrates how the console command ConfigCmds handles illegal input.
Secure> ConfigCmds <Return>
List of Enabled Console Commands: GC, GS, EC, FK
List of Enabled Host Commands: A0, A4, GG, GY
Enter command code (e.g. +CDE) or Q to Quit: X<Return>
Invalid entry.
Enter command code (e.g. +CDE) or Q to Quit: Q<Return>
Secure>
Note: When a disabled host command is invoked, error code 68 is returned. When a disabled console command is invoked, the message " Function not defined or not allowed" is displayed.